home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / zip_17g_.zip / ZIPPY.DOC next >
Text File  |  1991-09-30  |  11KB  |  241 lines
  1.  
  2.                                 ╓────────────────╖
  3.                                 ║ Program: ZIPPY ║
  4.                                 ║ Version: 1.7g  ║
  5.                                 ╙────────────────╜
  6.  
  7.                      ZIPPY Zip Date Scanner by Paul McGinness
  8.  
  9.      The idea behind ZIPPY is to read the most recent change date INSIDE
  10.  a ZIPFILE and clearly mark that date in the file desciption text.  This
  11.  saves your users from LOTS of unwanted downloads of old releases and helps
  12.  you, the sysop, keep tabs on old files.  ZIPPY will NEVER update the DOS
  13.  Date Stamp or File description Date stamp.
  14.  
  15.      Zippy turns a listing file from this:
  16.  
  17.  ╔═════════════════════╤════════════════╤═════════════════════════════════════╗
  18.  ║ Main Board (0)      │ Directory  (41)│ Main Board Upload Directory         ║
  19.  ║ Filename   │  Size  │  Date  │                 Description                 ║
  20.  ╙────────────┴────────┴────────┴─────────────────────────────────────────────╜
  21.  BOYAN51.ZIP    184848  06-02-91  Boyan Communications Version 5.0 1 of 2 Many
  22.                                 | New Features - The Best !
  23.  THELIST.ZIP     65916  06-02-91  TheList National BBS List for June 1, 1991
  24.                                 | Uploaded by: Stephen Hwang.
  25.  LABELS.ZIP      12265  06-02-91  Box Labelling.
  26.  
  27.  
  28.    To This:
  29.  
  30.  ╔═════════════════════╤════════════════╤═════════════════════════════════════╗
  31.  ║ Main Board (0)      │ Directory  (41)│ Main Board Upload Directory         ║
  32.  ║ Filename   │  Size  │  Date  │                 Description                 ║
  33.  ╙────────────┴────────┴────────┴─────────────────────────────────────────────╜
  34.  BOYAN51.ZIP    184848  06-02-91  Boyan Communications Version 5.0 1 of 2 Many
  35.                                 | New Features - The Best ! (Last Revised:
  36.                                 | 11/11/90)
  37.  THELIST.ZIP     65916  06-02-91  TheList National BBS List for June 1, 1991
  38.                                 | Uploaded by: Stephen Hwang. (Last Revised:
  39.                                 | 05/28/91)
  40.  LABELS.ZIP      12265  06-02-91  Box Labelling. (Last Revised: 01/23/91)
  41.  
  42.    Or This:
  43.  
  44.  ╔═════════════════════╤════════════════╤═════════════════════════════════════╗
  45.  ║ Main Board (0)      │ Directory  (41)│ Main Board Upload Directory         ║
  46.  ║ Filename   │  Size  │  Date  │                 Description                 ║
  47.  ╙────────────┴────────┴────────┴─────────────────────────────────────────────╜
  48.  BOYAN51.ZIP    184848  06-02-91  Boyan Communications Version 5.0 1 of 2 Many
  49.                                 | New Features - The Best !
  50.                                 | (Last Revised: 11/11/90)
  51.  THELIST.ZIP     65916  06-02-91  TheList National BBS List for June 1, 1991
  52.                                 | Uploaded by: Stephen Hwang.
  53.                                 | (Last Revised: 05/28/91)
  54.  LABELS.ZIP      12265  06-02-91  Box Labelling.
  55.                                 | (Last Revised: 01/23/91)
  56.  
  57.   -----------------------------------------------------------------------
  58.  
  59.    What happens when ZIPPY runs:
  60.  
  61.    1) Zippy takes the description file and renames it with an extention
  62.       of 001.  If another .001 file with the same name is found, then it
  63.       uses .002 or .003 etc. (up to a total of 999)
  64.  
  65.    2) Zippy creates (or appends) to an error log with the same filename
  66.       as the description file but an extention of .ERR.
  67.  
  68.    3) Zippy counts all the files in the target directory and displays the
  69.       number to you.
  70.  
  71.    4) Zippy reads the description file and searches the directory for
  72.       its match.  If found, Zippy checks the description for it's date
  73.       stamp.  If no stamp is found Zippy reads the ZIP file's internal
  74.       directory for the last revision date an adds the date stamp to the
  75.       description file.
  76.  
  77.    5) If the file can't be found, opened or found to be corrupted in any
  78.       way then the error log will be updated with that information as well
  79.       as the filename of the problem ZIPfile. The new description file
  80.       WILL NOT contain the description of a corrupted or missing file!
  81.       Please use the /O (Override) function switch to prevent this from
  82.       occuring if this is a problem to your setup.
  83.  
  84.    6) Zippy continues on with the above until the new directory description
  85.       file is complete.
  86.  
  87.    7) +++ NEW +++ Zippy creates or appends to a file called ZIPPY.RUN to
  88.       keep a log of all final parameters of the run.  This file is located
  89.       in the same directory that ZIPPY was run FROM.
  90.  
  91.                                   +++ NOTES +++
  92.  
  93.  A) Only ZIP files are date stamped.
  94.  B) Zippy will not delete a problem ZIP file but will delete it's entry in
  95.     the description file.
  96.  C) Zippy need be run only once on all directories EXCEPT current uploads.
  97.     Add Zippy to your EVENT sequence to take care of the upload areas.
  98.  D) Do not delete the .00x backup description files UNTIL you have checked
  99.     the new ones first.
  100.  E) Use the /O option whenever you suspect that files might be missing. As
  101.     long as this option is in effect you won't lose any descriptions due
  102.     to missing files.
  103.   -----------------------------------------------------------------------
  104.  
  105.  Syntax:  ZIPPY [file] [path] [header size] {Switches}
  106.  
  107.      eg:  ZIPPY dir00  d:\uploads  5 /n
  108.  
  109.  Where:
  110.  
  111.     FILE: Path/name of ASCII directory description file.
  112.  
  113.     PATH: Directory where the files can be found.
  114.  
  115.     SIZE:  Number of lines in FILE to be skipped before processing so
  116.            your header won't be ruined.  If your 1st description file
  117.            starts on line 8 then use a 7 as a header size.
  118.  
  119.     SWITCHES:
  120.  
  121.     /N  :  Create a NEWLINE for the date stamp no matter what length the
  122.            description is.
  123.  
  124.     /F  :  Force a Re-read of the ZIP file for Dates even if a stamp was
  125.            found.
  126.  
  127.     /U  :  MUST be used if you are running the 'Uploaded by:' program.
  128.            This switch makes sure that the 'Uploaded by:' line REMAINS
  129.            on it's own unique line.  BTW: The /U switch forces ZIPPY
  130.            to use the /N option as well!
  131.  
  132.     /S  :  **** SPITFIRE MODE ****.  This switch changes the continuation
  133.            character from a '|' in column 32 to a ',' in column 18 for
  134.            Spitfire continuation.
  135.  
  136.                       +++ New Switches for Version 1.7G +++
  137.  
  138.     /Q  : Quiet Mode.  No BEEPING when errors are found.  All errors are
  139.           handled the same way but without the sound effects.
  140.  
  141.     /O  : OVERRIDE mode or OFFLINE mode.  Be sure to use this switch when
  142.           you don't want to delete descriptions of ZIP files that weren't
  143.           found.  This is ideal for OFFLINE file checking (I don't know
  144.           why you'd want to run ZIPPY against files that don't exist but
  145.           who am I to argue).
  146.  
  147.   -----------------------------------------------------------------------
  148.  
  149.                                     The Screen
  150.  
  151.  
  152.  ╔═════════════════════════════════════════════════════════════════════════════╗
  153.  ║              ZIPPY 1.x: Zipfile Directory Date Stamping System              ║
  154.  ║                       CopyRight 1991 by Paul McGinness                      ║
  155.  ║                                                                             ║
  156.  ║(1) Input Directory File   : dir55                                           ║
  157.  ║(2) File Location Directory: c:\newfiles\hold\                               ║
  158.  ║                                                                             ║
  159.  ║(3) # Files in Directory : xxxx               (7) # Files Processed: xxxx    ║
  160.  ║                                                                             ║
  161.  ║(4) # Zip Files: xxxx                         (8) # Files Not Found: xxxx    ║
  162.  ║(5) # Non-Zip  : xxxx                         (9) # Files Corrupted: xxxx    ║
  163.  ║                                                                             ║
  164.  ║(6) # New Dates: xxxx                        (10) # Already Dated  : xxxx    ║
  165.  ║                                                                             ║
  166.  ║                   (11) Current Filename: xxxxxxxxxxxx                       ║
  167.  ║                   (12) Options in Effect: /x /y /z                          ║
  168.  ╚═════════════════════════════════════════════════════════════════════════════╝
  169.  
  170.  Fields:
  171.  
  172.   (1)  : Name of ASCII file containing file definitions.
  173.  
  174.   (2)  : Disk directory where the files from (1) will be found.
  175.  
  176.   (3)  : Total number of files in (2).  This number is NOT dependent on
  177.          the definition file (1).
  178.  
  179.   (4)  : As the program runs, this field is updated when a .ZIP is located
  180.          in (1) and (2).
  181.  
  182.   (5)  : Same as above BUT with NON-ZIP extentions.
  183.  
  184.   (6)  : Number of files that needed to be stamped.
  185.  
  186.   (7)  : Number of files read from (1).
  187.  
  188.   (8)  : Number of files in (1) not found in (2).  The description is
  189.          NOT copied to the new definition file.  The error file is updated
  190.          in this case.
  191.  
  192.   (9)  : Number of ZIP files with structural problems.  See the error file
  193.          for filenames and problem comments.
  194.  
  195.   (10) : Number of files either already stamped OR not in ZIP format.
  196.  
  197.   (11) : The file being processed now..
  198.  
  199.   (12) : Options in effect during this job run.
  200.  
  201.   -----------------------------------------------------------------------
  202.  
  203.    Reading the ZIPPY.RUN file:
  204.  
  205.   Fields     Description
  206.   ................................................-
  207.   Run Date
  208.       Time : When the ZIPPY command was involked.
  209.   Bkup     : Extention used for the backup file.
  210.   Filename : Name of Directory Description File.
  211.   Stamp    : Number of files that were newly stamped.
  212.   Bypass   : Number of files that had been stamped previously.
  213.   Read     : Total number of files found in the description file.
  214.   Missing  : Number of listed files that weren't found.
  215.   Zipped   : Number of files read that had .ZIP extentions.
  216.   Nonzip   : Number of files read that didn't have .ZIP ententions.
  217.   Corrupt  : Total corrupted files.  They are logged in the .ERR logfile.
  218.   -----------------------------------------------------------------------
  219.  
  220.                          THIS SOFTWARE IS NOT FOR SALE!!!
  221.  
  222.    That's correct, you can use it without a registration fee.  If you want
  223.  to send a donation to the cause then GREAT.
  224.  
  225.  Mail to:
  226.                                   Paul McGinness
  227.                                51 White Oak Street
  228.                              New Rochelle, NY, 10801
  229.  
  230.  
  231.    If you don't want to send money then at least let me know that you are
  232.  using ZIPPY and what you think of it!  I can be reached at ACC BBS at
  233.  914-636-1455.
  234.  
  235.       Also on RIME via the COMMON, BBSDOORS or SYSOP conferences. If you
  236.  like ZIPPY then try my DOOR programs for PCBoard. They are GUTS!, Time-Out
  237.  Trivia and The ULTIMATE BBS Word Search.
  238.  
  239.    Thanks and let's hear from you SYSOPS!
  240.  
  241.